feat(database-client): add db.sql tagged template - #191

@codex review

🦋 Changeset detected

Latest commit: 2f6b1ba

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Greptile Summary

The PR adds a parameterized db.sql tagged-template API to the database client.

• Converts every interpolation into a positional ? placeholder and encodes its value using existing binding rules.
• Rejects interpolated objects rather than interpreting them as named parameters.
• Adds execution and binding tests, user documentation, and a patch changeset.

Confidence Score: 5/5

The PR appears safe to merge with no actionable correctness, security, or compatibility issues identified.

The tagged template preserves interpolation order, routes values through the established encoder, constructs a normal Statement with positional arguments, and is covered across construction and execution paths.

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  T[Tagged SQL template] --> J[Join literal segments with ?]
  V[Interpolated values] --> E[encodeValue]
  J --> S[Statement]
  E --> A[Positional arguments]
  A --> S
  S --> X[Existing statement execution API]

_{Reviews (1): Last reviewed commit: "update changeset" | Re-trigger Greptile}

Codex Review: Didn't find any major issues. 🚀

Reviewed commit: 2f6b1ba9c8